cBevelCanvas is a sub-class of the canvas class which will allow you to draw a beveled group box (a group box with a 3D look). This type of group-box is used in many different software packages (i.e. ATM, GoMac, Action Files, etc...). cBevelGroupBox should be fully Appearance Manage compliant.
How to use it
1. Open an existing project or create a new project.
2. Drag the cBevelGroupBox icon into the Project window.
3. Open an existing window, or create a new window.
4. Drag a canvas control into the window, and size it according to how large you would like the Bevelled Group Box to be.
5. Set the Super of the canvas (in the Properties window) to "cBevelGroupBox"
Now, when you run your project and open the appropriate window, you will see the bevelled group box!
Events
Open
This event fires when the control is first created at runtime. It fires before the control is drawn, so this is a useful place to initially configure the cBevelGroupBox's properties.
Properties
A cBevelGroupBox control can be used without any configuration, however it also has several properties to help customize the control. Note that the examples provided below assume a bevel group box control named "bevelBox".
bevelWidth (integer)
This property sets the width of the bevel of the group box. It defaults to 2 pixels.
bevelBox.bevelWidth = 1
text (string)
This property allows you to add a label to the bevelled group box. By default, there is no text.
bevelBox.text = "Preferences:"
textFont (string)
This property allows you to change the typestyle of the bevelled group box's label. Note that you must place quotes around the font's name when assigning this property. It defaults to "System" (the system font).
bevelBox.textFont = "Geneva"
textSize (integer)
This property allows you to change the size of the bevelled group box's label. It defaults to 12 points.
bevelBox.textSize = 10
bold (boolean)
This property allows you to change the bold property of the bevelled group box's label. It defaults to false.
bevelBox.bold = true
italic (boolean)
This property allows you to change the italic property of the bevelled group box's label. It defaults to false.
bevelBox.italic = true
underline (boolean)
This property allows you to change the underline property of the bevelled group box's label. It defaults to false.
bevelBox.underline = true
It is recommended that you set the properties of the cBevelGroupBox in the control's open event. If you do it in this event, then the group box will display with your properties with no further need for code on your part. You can change the properties elsewhere in your code, though. However, if you change the code anywhere other than the open event, you will need to call the bevelGroupBox's refresh method before the changes will display.
bevelBox.refresh
What it does not do
Because the cBevelGroupBox is a sub-class of the canvas control, REALbasic does not recognize the control as an actual group box. Be sure to take this into account if using the cBevelGroupBox to group radio buttons and other similar controls.
Version History
1.1 Added Open event. REALbasic 2.x is now required.
1.0 Initial Release
Licensing Info
cBevelGroupBox is free for your use in your own projects with no further obligation on your part. You do not need to give me credit of any kind. However, I do maintain ownership of cBevelGroupBox. Please do not redistribute this custom class without this readme file.
